home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / set_combine_charset < prev    next >
Text File  |  2001-04-06  |  1KB  |  40 lines
  1. SYNOPSIS
  2.         void set_combine_charset (int* bitvector)
  3.         void set_combine_charset (string charset)
  4.  
  5. DESCRIPTION
  6.         Set the set of characters which can be combined into a single string
  7.         when already received en-bloc in charmode from the current interactive
  8.         user.
  9.  
  10.         Non-combinable characters and single received characters are returned
  11.         as separate strings as usual. The function must be called with the
  12.         interactive user being the command giver.
  13.  
  14.         The newline '\n' and the NUL character '\0' are always non-combinable.
  15.  
  16.         The charset can be given either directly as a string, or indirectly
  17.         as a bitvector.
  18.  
  19.         The bitvector is interpreted as an array of 8-bit-values and might
  20.         contain up to 32 elements. Character n is allowed to be output
  21.         if sizeof(bitvector) > n/8 && bitvector[n/8] & (1 << n%8) .
  22.  
  23.  
  24. EXAMPLE
  25.         // In a screen-oriented editor, most of the printable characters
  26.         // (excluding answers to editor prompts 'j', 'n' and 'q') can be
  27.         // combined into strings.
  28.         set_combine_charset("abcdefghijklmoprstuvwxz0123456789"
  29.                             "ABCDEFGHIJKLMOPRSTUVWXZ");
  30.  
  31.         // Disable any previous setting.
  32.         set_combine_charset("");
  33.  
  34.  
  35. HISTORY
  36.         Introduced in LDMud 3.2.8.
  37.  
  38. SEE ALSO
  39.         input_to(E)
  40.